GET
/
public
/
v1
/
toppie
/
reporting
/
campaigns
curl --request GET \
  --url https://api.topsort.com/public/v1/toppie/reporting/campaigns
{
  "campaigns": [
    {
      "adFormat": "listing",
      "adSpend": 1,
      "agencyCampaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "campaignName": "<string>",
      "chargedClicks": 1,
      "chargedImpressions": 1,
      "clicks": 1,
      "conversionRate": 123,
      "cpc": 123,
      "ctr": 123,
      "dailyBudget": 1000,
      "endDate": "2023-11-07T05:31:56Z",
      "impressions": 1,
      "isActive": true,
      "purchaseCount": 1,
      "purchaseRevenue": 1,
      "roas": 123,
      "startDate": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextPage": "SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
}

Query Parameters

​
next_page
string

Token for retrieving the next page.

​
limit
integer
default:100

Maximum number of campaigns to retrieve.

Required range: 1 <= x <= 1000
​
order_by
enum<string>

The order dimension for the campaigns to be retrieved.

Available options:
campaign_id,
name,
daily_budget,
impressions,
purchase_revenue,
roas,
cpc,
cpm,
ad_spend,
is_active,
ad_format,
start_date,
end_date,
created_at
​
direction
enum<string>

The order direction for the campaigns to be retrieved.

Available options:
asc,
desc
​
start_date
string

Start date for calculating metrics.

​
end_date
string

End date for calculating metrics.

​
search
string
default:""

A search string to filter the names of the campaigns by.

​
campaign_status
enum<string>

The campaign status to filter the campaigns by. Defaults to all statuses.

Available options:
all,
active,
inactive

Response

200
application/json

Successful Response

The response is of type object.

GET
/
public
/
v1
/
toppie
/
reporting
/
campaigns
curl --request GET \
  --url https://api.topsort.com/public/v1/toppie/reporting/campaigns
{
  "campaigns": [
    {
      "adFormat": "listing",
      "adSpend": 1,
      "agencyCampaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "campaignName": "<string>",
      "chargedClicks": 1,
      "chargedImpressions": 1,
      "clicks": 1,
      "conversionRate": 123,
      "cpc": 123,
      "ctr": 123,
      "dailyBudget": 1000,
      "endDate": "2023-11-07T05:31:56Z",
      "impressions": 1,
      "isActive": true,
      "purchaseCount": 1,
      "purchaseRevenue": 1,
      "roas": 123,
      "startDate": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextPage": "SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
}

Query Parameters

​
next_page
string

Token for retrieving the next page.

​
limit
integer
default:100

Maximum number of campaigns to retrieve.

Required range: 1 <= x <= 1000
​
order_by
enum<string>

The order dimension for the campaigns to be retrieved.

Available options:
campaign_id,
name,
daily_budget,
impressions,
purchase_revenue,
roas,
cpc,
cpm,
ad_spend,
is_active,
ad_format,
start_date,
end_date,
created_at
​
direction
enum<string>

The order direction for the campaigns to be retrieved.

Available options:
asc,
desc
​
start_date
string

Start date for calculating metrics.

​
end_date
string

End date for calculating metrics.

​
search
string
default:""

A search string to filter the names of the campaigns by.

​
campaign_status
enum<string>

The campaign status to filter the campaigns by. Defaults to all statuses.

Available options:
all,
active,
inactive

Response

200
application/json

Successful Response

The response is of type object.